feat: Add new app concept and better query cli command options to limit context usage#21
Merged
feat: Add new app concept and better query cli command options to limit context usage#21
Conversation
Every crumb is now stamped with an app name, auto-detected from the nearest package.json. Crumbs are stored per-app at ~/.agentcrumbs/<app>/ and all CLI commands scope to the current app by default. - Add app field to Crumb type and AgentCrumbsConfig - Add getApp() resolution: JSON config > AGENTCRUMBS_APP env > package.json - Per-app storage directories in collector/store - Collector routes incoming crumbs to per-app stores - All CLI commands support --app and --all-apps flags - New cli/app-store.ts shared helper for app context - Update format.ts to show app prefix in multi-app views - Add papertrail example app for demos - Update skills, docs, and homepage
Replace the old 'last N results' approach with forward pagination: - Add --after and --before for absolute ISO timestamp bounds - Default limit reduced from 100 to 50 for manageable pages - Output includes 'Next page: --after <timestamp>' when more results exist - Results returned oldest-first for natural forward pagination Update skill to guide agents toward broad queries with pagination instead of aggressive namespace/match filtering.
Replace raw timestamp pagination with short cursor IDs. Cursors are 8-char hashes stored in ~/.agentcrumbs/.cursors.json with 1-hour TTL. Flow: query --since 5m → output shows 'Next: --cursor a1b2c3d4' → query --since 5m --cursor a1b2c3d4 for next page. Keep --after/--before for explicit time windows.
- Fix storage path to ~/.agentcrumbs/<app>/crumbs.jsonl everywhere - Add app field to cross-language examples (curl, Python, Go, Rust) - Update CLI examples with --app, --all-apps, --cursor flags - Add AGENTCRUMBS_APP env var to README env var table - Update collect.mdx to show per-app routing - Update multi-service guide with per-app storage
- Add over-filtering as critical mistake #1 in core skill - Rewrite querying section with explicit CORRECT/AVOID examples - Fix CLI quick reference to show --cursor instead of --after - Add query + cursor examples to init skill template - Add inline guidance note to init template CLI section
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
nicktrn
approved these changes
Mar 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.